Function: addIdReference(domElementOrCSSSelector, stringAttributeName, stringID)

Shorthand: addIdRef(domElementOrCSSSelector, stringAttributeName, stringID)

Description: Adds one or more space delimited ID references to the specified attribute on an element.

Returns: domElement, or $A object if chained.

Note: Automatically recognizes when previous ID references have been set on the same element and appends them accordingly, or ignores them if the same ID references have already been set. Designed for use with specific ARIA attributes such as aria-describedby, aria-labelledby, aria-owns, and aria-controls.

Example:

var myElement = $A.addIdReference(gridCellNode, "aria-describedby", "tableColId tableRowId");

// Or the same using chaining

var myChain = $A(gridCellNode).addIdReference("aria-describedby", "tableColId tableRowId");

// To return the modified object within a chain, use the "return()" method.

var myObject = myChain.return();